[ <--- prev -- ]  [ HOME ]  [ -- next ---> ]

[ full index ]


BIASING

biases the multiplicity of secondaries (only for hadron or muon/photon photonuclear interactions) on a region by region basis. Sets importance sampling (Russian Roulette/splitting) at boundary crossing by region and by particle.

See also EMF-BIAS, LOW-BIAS, LAM-BIAS, WW-FACTOr, WW-PROFIle, WW-THRESh

The meaning of WHAT(1)...WHAT(6) and SDUM is different depending on the sign of WHAT(1):

If WHAT(1) >= 0.0 :

     WHAT(1) specifies the particles to be biased:
              = 0.0 : all particles
              = 1.0 : hadrons, heavy ions and muons
              = 2.0 : electrons, positrons and photons
              = 3.0 : low energy neutrons

     WHAT(2) = RR (or splitting) factor by which the average number of
               secondaries produced in a collision should be reduced (or
               increased). Meaningful only for hadron, heavy ion, or muon/photon
               nuclear interactions.
               This value can be overridden in the user routine UBSSET by
               assigning a value to variable RRHADR, see (13))
               Default = 1.0

     WHAT(3) = region importance (allowed values range from 0.0001 to 10000.)
               This value can be overridden in the user routine UBSSET by
               assigning a value to one or more of the variables IMPHAD, IMPLOW
               and IMPEMF (depending on the value of WHAT(1)).
               If SDUM = USER, setting WHAT(3) = 1. for a region will suppress
               all calls to routine USIMBS during traking inside that region.
               Default = 1.0

     WHAT(4) = lower bound (or corresponding name) of the region indices with
               importance equal to WHAT(3) and/or with multiplicity biasing
               factor equal to WHAT(2).
               ("From region WHAT(4)...")
               Default = 2.0

     WHAT(5) = upper bound (or corresponding name) of the region indices with
               importance equal to WHAT(3) and/or with multiplicity biasing
               factor equal to WHAT(2).
               ("...to region WHAT(5)...")
               Default = WHAT(4)

     WHAT(6) = step length in assigning indices.
               ("...in steps of WHAT(6)").
               Default = 1.0

     SDUM    = PRINT :   importance biasing counters are printed (useful to tune
                         importances and weight windows)
             = NOPRINT:  counters are not printed (cancels any previous PRINT
                         request)
             = USER:     importance biasing according to the user defined
                         routine USIMBS
             = NOUSER:   reset to default (cancels any previous USER request)
             = RRPRONLY: multiplicity biasing for primary particles only
             = blank:    ignored
             Default: NOPRINT, NOUSER, multiplicity biasing for all
                      generations (if requested)

If WHAT(1) < 0.0 :

     WHAT(1) : flag indicating that all region importances shall be modified by
               a particle-dependent factor, based on a modifying parameter as
               explained in the Note 3 below

     WHAT(2) >= 0.0 : modifying parameter M (see Note 3). See also WARNING
                      below.
             <  0.0 : M is reset to the default value 1.0 (i.e. no
                      modification)

     WHAT(3) = lower bound (or corresponding name) of the particle numbers to
               which the indicated modifying parameter applies
               ("From particle WHAT(3)...")
               Default: = 1.0

     WHAT(4) = upper bound (or corresponding name) of the particle numbers to
               which the indicated modifying parameter applies
               ("...to particle WHAT(4)...")
               Default: = WHAT(3) if WHAT(3) > 0, all particles otherwise

     WHAT(5) = step length in assigning  particle numbers
               ("...in steps of WHAT(5)").
               Default: 1.0.

     WHAT(6) = not used

     SDUM    = PRIMARY : importance biasing is applied also to primary
               particles (cancels any previous NOPRIMARy request)
               NOPRIMARy : importance biasing is applied only to secondaries
               Default = PRIMARY


WARNING:

Even if a BIASING card is issued only to set PRIMARY/NOPRIMARy, remember that a value of 0. is meaningful for WHAT(2). Leaving blank WHAT(2) to WHAT(5) has the effect of turning off all importance biasing for all particles!

Default (option BIASING not given): no multiplicity or RR/splitting biasing

Notes:

              - If I2 < I1, Russian Roulette will be played.
                Without any modifying factor, the chance of particle survival
                is I2/I1.
                For 0. <= M <= 1., the survival chance is modified to:
                              1. - M * (1. - I2/I1)
                It can be seen that a value M = 0. resets the chance of survival
                to 1., namely inhibits Russian Roulette biasing.
                A value M = 1. leaves the survival chance unmodified, while any
                value between 0. and 1. INCREASES the probability of survival
                with respect to the basic setting.
                For M >= 1., the survival chance is modified to:
                                  I2/(M * I1)
                So, a value larger than 1. DECREASES the probability of survival
                with respect to the basic setting.

              - If I2 > I1, there will be splitting. Without any modifying
                factor, the number of particles is increased on average by a
                factor I2/I1.
                With the modifying factor, the number of particles is increased
                instead by:
                              1. + M * (I2/I1 - 1.)
                It can be seen that a value M = 0. resets the splitting factor
                to 1., namely inhibits splitting.
                A value M = 1. leaves the number of particles unmodified; a
                value between 0.0 and 1.0 DECREASES the amount of splitting with
                respect to the basic setting; a value > 1 INCREASES the amount
                of splitting.

            Hint: One of the most common uses of the modifying factor is to play
                  Russian Roulette/splitting only for some selected particles: one
                  does that by inhibiting biasing for all other particles, i.e.
                  setting = 0. the modifying factor M (WHAT(2), with WHAT(1) < 0).

Example, for a number-based input:

 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
 BIASING          2.0       0.0      10.0       7.0      11.0      2.0
 BIASING          2.0       0.0      15.0       8.0       9.0      0.0
 BIASING         -1.0       0.0       3.0       4.0       0.0      0.0
 BIASING          1.0       0.7       0.4       3.0       8.0      0.0 PRINT
 *         In this example, the first two BIASING cards set an importance = 10
 *         for electrons, positrons and photons in regions 7, 9 and 11; and
 *         an importance = 15 in regions 8 and 9 for the same particles.
 *         However, the following card requires a modifying factor = 0.0
 *         (no splitting or Russian Roulette) for electrons and positrons.
 *         The net result is that biasing at boundary crossing with the above
 *         region importances is played only for photons.
 *         The fourth card sets a reduction factor = 0.7 for the multiplicity
 *         of hadronic events in regions 3, 4, 5, 6, 7 and 8; the importance
 *         of these same regions is set = 0.4; and it is required that biasing
 *         counters be printed.

The following is the same example, in a name-based input:

 BIASING          2.0       0.0      10.0   Seventh  Eleventh      2.0
 BIASING          2.0       0.0      15.0    Eighth     Ninth      0.0
 BIASING         -1.0       0.0  ELECTRON  POSITRON       0.0      0.0
 BIASING          1.0       0.7       0.4     Third    Eighth      0.0 PRINT